home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / ftn / arc.z / arc
Encoding:
Text File  |  2002-10-03  |  5.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4. aaaarrrrcccc((((3333GGGG))))                                                                aaaarrrrcccc((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      aaaarrrrcccc,,,, aaaarrrrcccciiii,,,, aaaarrrrccccssss - draw a circular arc
  10.  
  11. FFFFOOOORRRRTTTTRRRRAAAANNNN 77777777 SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee aaaarrrrcccc((((xxxx,,,, yyyy,,,, rrrraaaaddddiiiiuuuussss,,,, ssssttttaaaannnngggg,,,, eeeennnnddddaaaannnngggg))))
  13.      rrrreeeeaaaallll xxxx,,,, yyyy,,,, rrrraaaaddddiiiiuuuussss
  14.      iiiinnnntttteeeeggggeeeerrrr****4444 ssssttttaaaannnngggg,,,, eeeennnnddddaaaannnngggg
  15.  
  16.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee aaaarrrrcccciiii((((xxxx,,,, yyyy,,,, rrrraaaaddddiiiiuuuussss,,,, ssssttttaaaannnngggg,,,, eeeennnnddddaaaannnngggg))))
  17.      iiiinnnntttteeeeggggeeeerrrr****4444 xxxx,,,, yyyy,,,, rrrraaaaddddiiiiuuuussss,,,, ssssttttaaaannnngggg,,,, eeeennnnddddaaaannnngggg
  18.  
  19.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee aaaarrrrccccssss((((xxxx,,,, yyyy,,,, rrrraaaaddddiiiiuuuussss,,,, ssssttttaaaannnngggg,,,, eeeennnnddddaaaannnngggg))))
  20.      iiiinnnntttteeeeggggeeeerrrr****2222 xxxx,,,, yyyy,,,, rrrraaaaddddiiiiuuuussss
  21.      iiiinnnntttteeeeggggeeeerrrr****4444 ssssttttaaaannnngggg,,,, eeeennnnddddaaaannnngggg
  22.  
  23.      All of the routines named above are functionally the same.  They differ
  24.      only in the type assignments of their parameters.
  25.  
  26. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  27.      _x          expects the _x coordinate of the center of the arc. The center
  28.                 of the arc is the center of the circle that would contain the
  29.                 arc.
  30.  
  31.      _y          expects the _y coordinate of the center of the arc.  The center
  32.                 of the arc is the center of the circle that would contain the
  33.                 arc.
  34.  
  35.      _r_a_d_i_u_s     expects the length of the radius of the arc.  The radius of
  36.                 the arc is the radius of the circle that would contain the
  37.                 arc.
  38.  
  39.      _s_t_a_n_g      expects the measure of the start angle of the arc. The start
  40.                 angle of the arc is measured from the positive x-axis.
  41.  
  42.      _e_n_d_a_n_g     expects the measure of the end angle of the arc. The end angle
  43.                 of the arc is measured from the positive x-axis.
  44.  
  45. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  46.      aaaarrrrcccc draws an unfilled circular arc in the _x-_y plane (_z = _0). To draw an
  47.      arc in a plane other than the _x-_y plane, define the arc in the _x-_y plane
  48.      and then rotate or translate the arc.
  49.  
  50.      An arc is drawn as a sequence of line segments, and therefore inherits
  51.      all properties that affect the drawing of lines.  These include the
  52.      current color, writemask, line width, stipple pattern, shade model, line
  53.      antialiasing mode, and subpixel mode.  The stipple pattern is initialized
  54.      to bit zero of the current linestyle before the arc is drawn, then
  55.      shifted continuously through the segments of the arc.
  56.  
  57.      An arc is defined in terms of the circle that contains it.  All
  58.      references to the radius and center of the arc refer to the radius and
  59.      center of the circle that contains the arc. The angle swept out by the
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. aaaarrrrcccc((((3333GGGG))))                                                                aaaarrrrcccc((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      arc is the angle from the start angle counter-clockwise to the end angle.
  75.  
  76.      The start and end angles are defined relative to the positive x-axis. (To
  77.      speak more precisely, because the arc might not be centered on the
  78.      origin, the start and end angles are defined relative to the right
  79.      horizontal radius of the circle containing the arc).  Positive values for
  80.      an angle indicate a counter-clockwise rotation from the horizontal.
  81.      Negative values indicate a clockwise rotation from the horizontal.
  82.  
  83.      The basic unit of angle measure is a tenth of a degree. The value 900
  84.      indicates an angle of 90 degrees in a counter-clockwise direction from
  85.      the horizontal. Thus, an arc that spans from a start angle of 10 degrees
  86.      (_s_t_a_n_g = _1_0_0) to an end angle of 5 degrees (_e_n_d_a_n_g = _5_0) is almost a
  87.      complete circle.
  88.  
  89.      After aaaarrrrcccc executes, the graphics position is undefined.
  90.  
  91. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  92.      arcf, bgnclo, circ, crvn, linewi, linesm, lsrepe, scrsub, setlin, shadem,
  93.      subpix
  94.  
  95. BBBBUUUUGGGGSSSS
  96.      When the line width is greater than 1, small notches will appear in arcs,
  97.      because of the way wide lines are implemented.
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.